📚 StoryGraph Book Scraper — Ratings, Moods & Pace + New-Release Monitor

Scrape StoryGraph books by search term or URL — title, author, page count, description, cover — plus the data StoryGraph is famous for and Goodreads doesn't have: the community average rating, review count, MOODS (% dark / tense / emotional / adventurous…) and PACE (% fast / medium / slow). Then run it on a schedule to monitor new releases and get a Slack / email / webhook ping the moment a matching book appears.

No login, no browser automation — every field comes straight from StoryGraph's server-rendered pages.

---

What does StoryGraph Book Scraper do?

It turns StoryGraph book pages into clean, structured rows you can export to JSON, CSV, Excel, or push to your app via API. For each book it pulls the catalog details and the community-reviews panel — the mood and pace breakdowns that make StoryGraph the reader's-choice alternative to Goodreads.

• 🔎 Search by keyword — title, author, or series ("project hail mary", "fourth wing", "brandon sanderson"). Server-side.
• 🔗 Or pass exact book URLs / IDs — scrape a specific reading list.
• ⭐ Community rating + review count — the real average and how many readers it's based on.
• 🎭 Moods — the % of readers who tagged it dark, tense, emotional, adventurous, funny, hopeful, reflective, mysterious…
• ⚡ Pace — the % who found it fast, medium, or slow.
• 📖 Catalog — pages, format, first-published year, edition count, full description, cover.
• 🔔 New-release monitor — schedule it and get Slack / email / webhook alerts when a new book matches your search (e.g. a favourite author's next title).

---

What data does it extract?

For every book:

• 🆔 book_id, 🔗 book_url, 🏷️ title
• ✍️ author, author_url
• 📝 description, 🖼️ cover
• 📄 pages, format, 📅 first_published, editions
• ⭐ average_rating, 🗳️ reviews_count
• 🎭 moods (object: { "dark": 77, "tense": 62, … } — values are %)
• ⚡ pace (object: { "fast": 30, "medium": 62, "slow": 6 })
• ✨ is_new (monitor mode), 🕒 scraped_at

---

Who is it for?

• 📊 Book-data & recommendation builders who want mood/pace signals, not just a star average.
• 📱 BookTok / Bookstagram creators & newsletters tracking what's trending and how it feels to read.
• 🏪 Authors & publishers monitoring a title's community rating, review velocity, and mood profile.
• 🤖 App / ML developers enriching a catalog with reader-sentiment features.

---

Two ways to use it

1. Bulk scrape — search a term (or paste a list of book URLs) and pull every match into one clean dataset with ratings, moods, and pace.
2. New-release monitor (the recurring play) — set monitorMode: true, attach an Apify Schedule, and the actor outputs/alerts only newly-appearing books for your search. Perfect for watching an author or a genre/mood browse.

---

How to use it (step by step)

1. Click Try for free.
2. Enter a search term (e.g. project hail mary) — or paste Book URLs.
3. (Optional) keep Fetch community ratings, moods & pace on (the differentiator).
4. (Optional) set a Min average rating or Max books.
5. Click Start, then open the Dataset tab to view/export.
6. (Optional) set monitorMode + a Schedule + an alert channel to get pinged on new releases.

Quick start

{ "searchTerm": "fourth wing", "maxBooks": 25 }

New-release monitor example

{
  "searchTerm": "rebecca yarros",
  "monitorMode": true,
  "alertOnNewBook": true,
  "slackWebhookUrl": "https://hooks.slack.com/services/…"
}

---

Input

Field	What it does
searchTerm	server-side browse search over title / author / series
bookUrls	explicit /books/{uuid} URLs or bare UUIDs to scrape
fetchReviews	also pull average rating, review count, moods, and pace (one extra request/book)
minRating	client-side filter: keep books rated at/above this
maxBooks	hard cap per run (0 = unlimited)
sortBy	default · rating_desc · rating_asc · reviews_desc · title
monitorMode, alertOnNewBook	recurring new-release watcher + alerts
webhookUrl, slackWebhookUrl, emailRecipients	alert channels
proxyConfiguration, requestConcurrency	proxy + parallelism

---

Output

Each book is one dataset record (fields above). Export to JSON, CSV, Excel, HTML, or RSS, or fetch via the Apify API. moods and pace are objects whose values are percentages of community readers.

---

How much does it cost?

Pay-per-event — you pay for what you pull, no subscription. Suggested rates:

Event	What it covers	Suggested price
lot-scraped	each book returned	~$0.003 / book
lot-detail-enriched	each community-reviews fetch (ratings/moods/pace)	~$0.003 / book
monitor-run-completed	each scheduled watch run	~$0.05 / run
new-lot-detected	each newly-appearing book	~$0.02 / book
alert-delivered	each Slack/email/webhook push	~$0.005 / alert

(Final per-event prices are set on the actor's pricing page.)

---

Is it legal to scrape StoryGraph?

This actor reads public, login-free book catalog and aggregate community statistics (a numeric average rating and anonymous mood/pace percentages) — it does not collect individual users, reviews, or personal data. Scraping publicly available data is generally legal, but you are responsible for your use: review the current StoryGraph Terms of Service before commercial use or redistribution of the data.

---

FAQ

What is StoryGraph? TheStoryGraph is a popular Goodreads alternative that lets readers track books and adds community mood and pace breakdowns alongside the star rating.

Do I need an account or login? No. The actor reads public book pages directly.

What makes this different from a Goodreads scraper? The moods and pace fields — StoryGraph's signature reader-sentiment data — plus the community average rating and review count, all in one row.

Can I monitor an author's new releases? Yes. Search the author's name, set monitorMode, attach an Apify Schedule, and add a Slack/webhook/email channel — each run alerts only books new since the last run.

How do I export the data? JSON, CSV, Excel, HTML, or RSS from the Dataset tab, or via the Apify API.

---

Feedback

Found a missing field or want a new filter (content warnings, genre tags, series order)? Open an issue on the actor — fast fixes and feature requests welcome.